Setup Wizard

The Setup Wizard is a tool used with the Visual Basic Setup Toolkit that helps you create application setup and distribution media. You can also use the Setup Wizard to create dependency (.dep) files.

Note   The Setup Wizard is designed for Visual Basic developers and isn't a general Windows Setup Tool.

Using the Microsoft Setup Wizard provides a number of options for the distribution of your application. The Setup Wizard supports:

•	Multiple floppy disks, and can split files that are too large to fit onto a single floppy.

•	Copying your files to a hard disk directory for distribution over a network or on CD-ROM.

•	Distribution of your application across the Internet using automatic code download from Microsoft Internet Explorer, Version 3.0.

You can start the Setup Wizard by choosing either Application Setup Wizard from your Start menu or Setupwiz.exe from \Setupkit\Kitfil32 directory where you installed Visual Basic.

Based on information you provide, the Setup Wizard creates a special Setup.lst file. This information is then kept in the Vb5dep.ini file in your Windows directory.

Note   The Setup Wizard is not a disk duplication tool. If you want to make copies of your master distribution disks, use a disk copying application.

Note   When you create a new project Visual Basic adds some controls to the Toolbox and a reference to Data Access Objects (DAO). Setup Wizard recognizes the controls and references whether or not you use them in your application. If controls that you have not used in your application appear in the Confirm Dependencies step or if the Data Access step appears and you know you did not add any references to Data Access, you should clear the unused files. Either remove the tools and references manually from your source files or clear the checkbox for them in the file list.


Setup Wizard - Missing Dependencies
Setup Wizard — Missing Dependencies

The Setup Wizard was unable to find dependency information for the files displayed in the list. Setup Wizard looks for dependency information in the Vb5def.ini and/or in special dependency files (.dep) that should exist for each EXE, OCX, and DLL in your application.

If an indicated file(s) comes from a third party, contact that party for dependency information or for the necessary dependency files (.dep).

If one of the files in the list is a project that you created in Visual Basic, you can use the Setup Wizard to create a dependency file for that project. Restart the Setup Wizard, select the project file (.vbp) for this component, and choose the Generate Dependency File Only option. Continue through all the steps to create the missing dependency file. Then, restart the Setup Wizard and try the current project again.

If you are certain that a file in the list does not need additional information, select it making sure that a check mark appears to the left of it. This will let the Setup Wizard know that this file has no dependencies, and the particular file will not appear in this dialog on your machine in the future.

Note   If you leave some files unchecked, a dialog appears asking if you want the Setup Wizard to ignore the missing dependency information for this session. You can choose Yes and continue. You can also select not to see the dialog box in the future when you have missing dependency files.

Wizard Options

Missing Dependency Files List   Lists the files for which the Setup Wizard can find no dependency files.

Help   Displays the help topic for this step. You can also press F1 for help.

Cancel   Cancels your previous actions and closes the Setup Wizard.

Back   Moves you to the previous step.

Next   Moves you to the next step.

Finish   Creates a setup using the settings you selected and displays a confirmation dialog. Available only when you have provided enough information for the Setup Wizard to successfully create a setup package.


Setup Wizard - Finished!
Setup Wizard — Finished!

The Setup Wizard has collected the information necessary to begin processing your distribution files.

The Setup Wizard notifies you when it has finished creating the distribution media.

Wizard Options

Save Template   Displays the Save Template As dialog box where you can name and save your template in a location of your choosing. A template is a way of saving the current settings so that you can re-use them later. Load the template in the Select Project and Options step instead of a project (.vbp) file when you are asked to select a project.

Help   Displays the help topic for this step. You can also press F1 for help.

Cancel   Cancels your previous actions and closes the Setup Wizard.

Back   Moves you to the previous step.

Next   Disabled in this step.

Finish   Creates a setup using the settings you selected and displays a confirmation dialog. Available only when you have provided enough information for the Setup Wizard to successfully create a setup package.


Remote Connection Details Dialog Box

Allows you to provide the settings necessary for the end user's machine to find and connect to a remote server. When end users run the setup program, they will be required to provide any information necessary for the connection that you did not enter here.

Dialog Box Options

Remote Support File   Displays the name and path for the selected file. This is read-only, and is there for your convenience so you can see what file you are working on.

Remote Transport

Distributed COM (DCOM) — Your application uses DCOM to access the component.

Remote Automation — Your application uses Remote Automation to access the component.

Connection Information   Provides information needed to connect to the component across the network.

Network Address — Lets you type the network address of the machine where the server application will be installed. If you leave this field blank, your users will be asked for this information when they execute setup.

Network Protocol — Displays a list of the network protocols from which you may choose. Available only if you selected Remote Automation. If you leave this field blank, your users will be asked for this information when they execute setup.

Authentication   Available only if you chose Remote Automation. Required. For more information, see RPC Security in your Windows NT documentation.


Safety Dialog Box

Lists the components and lets you mark selected components as safe for initialization and/or safe for scripting. For Internet installations only. Making a component safe means that you claim it will not do harm to the end user’s machine.

Warning   By marking a component as safe for scripting or safe for initialization, you are guaranteeing that your component can never corrupt or cause undesirable behavior on an end user’s machine, even if used in a Web page that you yourself did not author. Marking a component as either safe for scripting or safe for initialization may imply that you are accepting liability for this guarantee.

Note   You must have your .cab files signed in order to take full advantage of these options. For more information about .cab files, see the Programmer’s Guide.

Dialog Box Options

Components   Lists the public UserControls, Classes, and/or UserDocuments within your ActiveX control, ActiveX EXE, and ActiveX DLL project. Select the item you want to mark as safe, and then select the appropriate option. You can select only one item at a time.

Note   You must mark each item that you want to be safe. Repeat the process for each.

The selected component is:

Safe for initialization — Marks the component as safe for initialization. A control author should mark a control as "Safe for initializing" if, and only if, the control will not forsake security when initialized from any data, especially malicious data. This means the control will not produce any behavior that a reasonable user would deem unacceptable in the context of that user's expectations of the control's behavior. This is not a statement about the intentions of a control, but rather a promise from the control author that the control is impervious to damage attempted by malicious data. For example, a control marked "Safe for initializing" will not corrupt the end user's system regardless of data passed to the component during initialization. For controls marked "Safe for initializing", initialization data will not cause the control to create, change or delete arbitrary files, even temporary ones, or change system settings using this control.

Safe for scripting — Marks the component as safe for scripting. A control author should mark a control as "Safe for scripting" if, and only if, the control will not forsake security when scripted from any script, especially malicious scripts. This means the control will not produce any behavior that a reasonable user would deem unacceptable in the context of that user's expectations of the control's behavior. This is not a statement about the intentions of a control, but rather a promise from the control author that the control is impervious to damage attempted by malicious scripts. For example, a control marked "Safe for scripting", will not corrupt the end user's system no matter how it is scripted (how it is used programmatically in a Web page). For a control where users do not expect information to be collected about themselves or their personal computer, the control could not make such information available to a script. For controls marked "Safe for scripting", scripts should not be able to create, change or delete arbitrary files, even temporary ones, or change system settings using this control.

Note   You can choose one or both of these options.

Help   Displays help for the dialog box.

OK   Accepts your selections and closes the dialog box.

Cancel   Cancels your actions and closes the dialog box.


Setup Wizard  File Summary
Setup Wizard — File Summary

Lists all the files you need to distribute with your application.

You should clear the checkbox of all files for which you do not have distribution rights. List in your release notes the files whose checkboxes you cleared so that your users can be sure they have all necessary files.

Wizard Options

File List   Lists the files necessary for your application to function properly.

Add   Adds a file(s) to the file list box. You can make multiple selections from the Add Files dialog box.

You can add a file to the distribution list, even if it is not required by the application. However, you cannot have duplicate filenames in this list even if they are located in different directories. If you try to add a duplicate file, a message box will notify you of the error.

Note   If the Setup Wizard cannot find dependency information in Vb5dep.ini or an associated .dep file for the file you are trying to add, it displays a message box asking you if you still want to include the file. If you choose to include the file anyway, any dependency information needed by this file will not be included in the setup package and, as a result, your setup and application may not work properly. You can choose not to see this message for this file in the future.

If you know there are no dependencies, you can continue or you can return to the Select Project and Options screen and create a dependency file for this file.

File Details   Use to display file size, file date and time, and current and destination location for the file you selected in the file list boxes. Version information is also displayed if available.

You can change the Installed Location for the selected file. However, changing the installed location of a shared file or remote ActiveX server may adversely affect its functionality.

If you are creating a setup for downloading from the Internet, the Destination Directory option is not available. Also, .vbl files can be downloaded from the Internet but are not registered. The end user must register the files using RegEdit.

Caution   Changing the shared file status or the Destination Directory of a shared file or remote ActiveX server may adversely affect that component's capabilities and impair the removal of that component later. For example, if the same shared ActiveX component is installed to two different directories, the removal of one of them may result in removal of the registry information that makes each of them accessible, rendering the remaining component inaccessible.

Summary Details   Displays a dialog box listing the number of program and setup files, the total number of files, the uncompressed bytes for each program and setup file, the total number of uncompressed bytes, and the path to the setup target.

Dependency Of   Indicates the file that is needed by the selected file.

Help   Displays the help topic for this step. You can also press F1 for help.

Cancel   Cancels your previous actions and closes the Setup Wizard.

Back   Moves you to the previous step.

Next   Moves you to the next step.

Finish   Creates a setup using the settings you selected and displays a confirmation dialog. Available only when you have provided enough information for the Setup Wizard to successfully create a setup package.


Setup Wizard - ActiveX Server Components
Setup Wizard — ActiveX Server Components

Provides you with the means for including additional ActiveX components in your project.

Note   You may want to clear the checkbox for files that you know will already exist on the user's machine. You must also clear the checkbox of any files for which you do not have distribution rights. List in your release notes the files whose checkboxes you cleared in this screen so that users can be sure they have all necessary files.

Wizard Options

ActiveX Components List   Displays a list of ActiveX components created when the Setup Wizard searched your project file (.vbp) and found references to ActiveX server components used in your application.

Add Local   Displays the Add Local dialog box where you can locate and choose ActiveX components (*.dll, *.exe, *ocx) to the list of files to be distributed with your application. The Add Local dialog box is an Open common dialog box.

Add Remote   Displays the Add Remote dialog box where you can locate and choose Remote ActiveX Components (*.vbr) to add to the list of files to be distributed with your application. The Add Remote dialog box is an Open common dialog box.

Remote Details   Displays the Remote Connection Details dialog box where you can select Distributed COM (DCOM) or Remote Automation and add the network address, network protocol, and authentication information needed in order for the remote ActiveX component to function correctly.

File Details   Displays the File Details dialog box where you can view information about your file.

Help   Displays the help topic for this step. You can also press F1 for help.

Cancel   Cancels your previous actions and closes the Setup Wizard.

Back   Moves you to the previous step.

Next   Moves you to the next step.

Finish   Creates a setup using the settings you selected and displays a confirmation dialog. Available only when you have provided enough information for the Setup Wizard to successfully create a setup package.


Setup Wizard - Confirm Dependencies
Setup Wizard — Confirm Dependencies

Allows you to confirm additional file dependencies found by the Setup Wizard. The Setup Wizard lists any additional files, for example ActiveX controls used by or files referenced by your project.

Note   You may want to clear the checkbox of any files that you know will already exist on the user's machine. You must also clear the checkbox of any files for which you do not have distribution rights. List in your release notes the files whose checkboxes you cleared so that users can be sure they have all necessary files.

Note   When you create a new project, Visual Basic adds some controls to the Toolbox and a reference to Data Access Objects (DAO). Setup Wizard recognizes the controls and references whether or not you use them in your application. If controls that you have not used in your application appear in the Confirm Dependencies step or if the Data Access step appears and you know you did not add any references to Data Access, you should clear the unused files. Either remove the tools and references manually from your source files or clear the checkbox for them in the file list.

Wizard Options

File with dependencies list   Lists the dependencies found for your application.

File Details   Displays the File Details dialog box.

Help   Displays the help topic for this step. You can also press F1 for help.

Cancel   Cancels your previous actions and closes the Setup Wizard.

Back   Moves you to the previous step.

Next   Moves you to the next step.

Finish   Creates a setup using the settings you selected and displays a confirmation dialog. Available only when you have provided enough information for the Setup Wizard to successfully create a setup package.


Setup Wizard - Data Access
Setup Wizard — Data Access

The Setup Wizard has determined that you are using Data Access Objects (DAO) and lets you select any ISAM database format(s) you are using in your application. The appropriate ISAM engine files will be included in your setup program. You can also specify the type of workspace, Jet or ODBCDirect, that your application uses.

Note   When you create a new project, Visual Basic adds some controls to the Toolbox and a reference to Data Access Objects (DAO). Setup Wizard recognizes the controls and references whether or not you use them in your application. If controls that you have not used in your application appear in the Confirm Dependencies step or if the Data Access step appears and you know you did not add any references to Data Access, you should clear the unused files. Either remove the tools and references manually from your source files or clear the checkbox for them in the file list.

Wizard Options

Installable ISAM's   Lists available ISAM database formats you want to include. When you select one or more of these formats, a special file(s) is added to your distribution list that supports this format.

What type of Workspaces are you using?   Determines which components you ship with Data Access Objects (DAO).

dbUseJet — Includes the Jet database files with your setup. If you choose any of the ISAM formats listed in the Installable ISAMs list, dbUseJet is automatically selected and cannot be cleared because, by using an ISAM (restrictive clause), you need to include the Jet engine files.

dbUseODBC — Includes the Remote Data Objects (RDO) files with your setup. If you use the ODBCDirect features of Data Access Objects (DAO), select this option.

Note   You cannot clear both of these options. You must have one or both of them selected to proceed to the next step. If your application uses both the Jet engine and ODBCDirect, choose both options. Jet and RDO will be included in your setup. If you do not access any data through the Jet engine, and you use ODBCDirect exclusively, choose only dbUseODBC.

Help   Displays the help topic for this step. You can also press F1 for help.

Cancel   Cancels your previous actions and closes the Setup Wizard.

Back   Moves you to the previous step.

Next   Moves you to the next step.

Finish   Creates a setup using the settings you selected and displays a confirmation dialog. Available only when you have provided enough information for the Setup Wizard to successfully create a setup package.


Setup Wizard - Distribution Method
Setup Wizard — Distribution Method

Allows you to choose the way you want to distribute your application.

Wizard Options

Floppy Disk   Copies setup.exe and all of the setup files for your project onto floppy disks.

Single Directory   Copies setup.exe and all of the setup files into a single directory from which your users can run setup.

Disk Directories   Creates multiple directories such as \Disk1, \Disk2, and \Disk3, and copies the files into appropriate directories as if each directory represented a floppy disk in your setup. Your users can run setup from \Disk1 or make floppies from the disk images.

•	You should delete all subdirectories and files in the targeted directory using the Windows Explorer or File Manager before continuing. Setup Wizard does not do this for you.

•	You cannot choose the root drive of a network or local drive unless it is a floppy drive.

Help   Displays the help topic for this step. You can also press F1 for help.

Cancel   Cancels your previous actions and closes the Setup Wizard.

Back   Moves you to the previous step.

Next   Moves you to the next step.

Finish   Creates a setup using the settings you selected and displays a confirmation dialog. Available only when you have provided enough information for the Setup Wizard to successfully create a setup package.


Setup Wizard - Floppy Disk
Setup Wizard — Floppy Disk

Gathers information about the local destination and disk size for an application that you want to distribute on floppy disks.

Wizard Options

Floppy Drive   Lists only the disk drives that appear on the current machine.

Disk Size   Lists the available disk sizes.

Help   Displays the help topic for this step. You can also press F1 for help.

Cancel   Cancels your previous actions and closes the Setup Wizard.

Back   Moves you to the previous step.

Next   Moves you to the next step.

Finish   Creates a setup using the settings you selected and displays a confirmation dialog. Available only when you have provided enough information for the Setup Wizard to successfully create a setup package.


Setup Wizard - Internet Distribution Location
Setup Wizard — Internet Distribution Location

Gathers information about the directory where you want the Setup Wizard to place the Cabinet (.cab) file it creates, HTML sample code, any documentation, and additional files, and where it should create the \Support sub-directory.

Note   You have to copy the .cab files from this directory to your web site.

Note   The generated .cab file will not contain all of the runtime support files required to run your component. The .cab file contains an .inf file which points to the required runtime components and downloads them only as necessary. For example, it will download vbrun500.cab. The runtime .cab files are available on the Microsoft Web site and may be automatically downloaded from there, or can be moved to a location within your intranet. The benefit of this approach is that the Setup Wizard-generated .cab file downloads faster if it does not contain all of the support files that may already exist on the end user's machine.

The Setup Wizard creates .cab files from ActiveX Control projects and ActiveX EXE and ActiveX DLL projects that have public classes. This includes projects that contain UserDocuments. The .cab files can be automatically downloaded, expanded, and installed by Microsoft Internet Explorer, version 3.0, when referenced from an HTML page using the CODEBASE tag.

Setup Wizard does the following:

•	Creates a .cab file for the project's components, leaving additional space to let you digitally sign your .cab files. This file will be in the directory you specify. For more information on digitally signing see the ActiveX SDK.

•	Creates an .inf file, used within the .cab file, which describes how to download and register the project's components and describes where and how to download other .cab files containing the VB runtime, VB supplied ActiveX controls, and other runtime components such as DAO.

•	Creates a sample HTML template which includes the OBJECT and CODEBASE tags for the given component.

•	Creates a subdirectory off of the user-specified directory (\Support) which contains all of the components (namely the .inf and .ddf files) built into the .cab so users can make modifications and regenerate the .cab file on their own if necessary.

•	Provides means for specifying that components are Safe for Scripting and Safe for Initialization. Places appropriate information into the .inf file so that registry information will be written during the installation process.

Setup Wizard does not automatically create the .lpk files that are needed if your component requires licensing. You can use LPK_tool.exe in the \Tools directory on your Visual Basic CD to do this.

Note   If you try to place files in a directory that is not empty, Setup Wizard tells you that there are files and/or subdirectories in that directory. You will be asked if you want to continue. If you choose Yes to continue, Setup Wizard will place the files in that location. Even if you are creating multiple disks, the files with the same name will be overwritten, but other existing files will not be automatically deleted. It is recommended that you delete the contents of the directory before proceeding.

Wizard Options

Destination   Lists the destination of the directory where you want the installation files to be placed. First you select the drive where you want your files placed. Then you select the specific directory. If the directory does not exist, Setup Wizard will ask you if you want to create one. The last box allows you to see the tree structure of your path.

Note   Use the directory list box to change the path by double-clicking on the drive or folder where you want the files to go.

Help   Displays the help topic for this step. You can also press F1 for help.

Cancel   Cancels your previous actions and closes the Setup Wizard.

Back   Moves you to the previous step.

Next   Moves you to the next step.

Finish   Creates a setup using the settings you selected and displays a confirmation dialog. Available only when you have provided enough information for the Setup Wizard to successfully create a setup package.


Setup Wizard - Introduction
Setup Wizard — Introduction

Helps you create a setup a program and/or dependency files for your application.

Wizard Options

Skip this screen in the future   When selected, the Setup Wizard will not show the Introduction screen the next time you start it.

If you want to see this screen in the future, click the Back button on the first step of the wizard.

Help   Displays the help topic for this step. You can also press F1 for help.

Cancel   Cancels your previous actions and closes the Setup Wizard.

Back   Disabled in this step.

Next   Moves you to the next step.

Finish   Creates a setup using the settings you selected and displays a confirmation dialog. Available only when you have provided enough information for the Setup Wizard to successfully create a setup package.


Setup Wizard - Out of Date Dependencies
Setup Wizard — Out of Date Dependencies

Lists the file whose dependency location contains information that thinks the file is out of date. For example, it lists a file whose information in the dependency file for a file that is older than the current file. The Setup Wizard uses version information to determine this. If version information cannot be found, the Setup Wizard uses the date of the file in the format mm/dd/yyyy H/mm/ss to evaluate for out of date dependencies.

Note   The version information in the dependent file must be an exact match. Either older or newer versions are considered out of date. When the Setup Wizard uses the date information, the newer date is used for the match.

Having out of date dependency information can cause setup and your application not to work correctly. If you choose not to rebuild files with out of date dependencies, a dialog box appears asking you to confirm that you want the Setup Wizard to continue even though the dependency information is out of date. You can also choose not to see the dialog box in the future.

Note   If you see this dialog, one or more dependency files (.dep) are out of date with respect to a component in the list. This means that the component is newer than the version recorded in the dependency file. Since it is possible for the component's set of dependency information to have changed since the dependency file was created, the Setup Wizard cannot be certain that this dependency information is correct.

If the indicated file(s) comes from a third party, contact that party for updated dependency files (.dep).

If the indicated file(s) is a Visual Basic component that you created, restart the Setup Wizard, select the project file for this component and the Generate Dependency File Only option, and continue through all the steps to create the out-of-date dependency file. Then, restart the Setup Wizard and try the current project again.

Wizard Options

Files With Out of Date Dependencies List   Lists the files that have dependency information that is out of date.

Help   Displays the help topic for this step. You can also press F1 for help.

Cancel   Cancels your previous actions and closes the Setup Wizard.

Back   Moves you to the previous step.

Next   Moves you to the next step.

Finish   Creates a setup using the settings you selected and displays a confirmation dialog. Available only when you have provided enough information for the Setup Wizard to successfully create a setup package.


Setup Wizard - Select Project and Options
Setup Wizard — Select Project and Options

Allows you to choose the Visual Basic project (.vbp) file of, or Setup Wizard template (.swt) file for, the application that you want to distribute and lets you choose to create a setup program – with or without a dependency file –, an Internet download setup, or a dependency file only. The Setup Wizard reads the .vbp and source files for information on which objects, references, resources, dynamic-link libraries, and so forth need to be included in the distribution files, as well as the location of your .exe or .dll file.

Tip   It is good development practice to always provide a dependency (.dep) file with your application if it is a shared component such as an ActiveX control or ActiveX component, even if the dependency file simply indicates that there are no dependencies for the component other than the Microsoft Visual Basic runtime files.

Wizard Options

Project Location   Lets you type the name of the project file you want to distribute and its location on your machine. If the executable (.exe, .dll, or .ocx) file doesn't exist for the specified application, the Setup Wizard automatically builds it.

Browse   Displays the standard Open common dialog box where you can locate and choose the project file of the application that you want to build. The selected filename is automatically inserted in the Project Location field.

Rebuild the Project   When selected, forces a rebuild of the project's .exe, .dll. or .ocx file whether or not Setup Wizard finds an existing .exe, .dll, .ocx file for your project.

Choose this option if you want to rebuild before distributing your application.

Note   You must build your project and save the project file at least once before using the Setup Wizard. Not doing so may cause Setup Wizard to fail and your setup distribution may not work properly.

Options

•	Create a Setup Program

Generate Dependency File — Generates a file that contains dependency information and includes it in the setup.

Dependency files are used for any object of an .ocx, .dll, or .exe, ActiveX component, or a project that could be used as a component in other projects.

The default install location for the .dep files is the same directory as the install location of the .ocx. You can change the install location for the .dep in the File Details dialog box from the File Summary step.

Note   Changing the location of the .dep file may prevent Setup Wizard from finding it when it is part of a subsequent Setup Wizard session on a project using this component.

Note   You cannot have two files with the same base name that require dependency files. Each file must have a unique dependency file and by default the dependency file uses the same name as the file, but adds to it the .dep extension.

•	Create Internet Download Setup — Allows you to create an Internet download setup for only ActiveX Control projects and ActiveX EXE, and ActiveX DLL projects that have public classes, including projects that contain UserDocuments. Not available in the Visual Basic Learning Edition.

Note   When you select this option, a What's New button appears. Clicking What's New displays a Microsoft Web page where you can view and download current information on Internet download.

•	Generate Dependency File Only — Generates a dependency file with the same name as your project and a .dep extension, and places it in the same directory as your project.

To correctly create the dependency file, you must provide accurate information (as if you were actually creating a setup for the application) for all of the remaining steps of the Setup Wizard. The dependency file will contain dependency information, for example, dependent files, their destinations, and their versions, necessary to install the project as part of another application.

What's New   Takes you to the Microsoft Web site where you can browse for additional information about the Internet download.

Only available if you chose Create Internet Download Setup.

Help   Displays the help topic for this step. You can also press F1 for help.

Cancel   Cancels your previous actions and closes the Setup Wizard.

Back   Moves you to the previous step.

Next   Moves you to the next step.

Finish   Creates a setup using the settings you selected and displays a confirmation dialog. Available only when you have provided enough information for the Setup Wizard to successfully create a setup package.


Setup Wizard - Shared ActiveX Application
Setup Wizard — Shared ActiveX Application

Determines whether to distribute your application as a separate application in its own directory on the end user’s machine, or as a shared ActiveX component. If installed as a shared ActiveX component, this step allows you to determine whether this component will be installed onto a remote server machine accessed through Remote Automation.

Wizard Options

Install as a stand-alone application   Installs the file as a stand-alone file into the application directory that the end user will specify.

Install as a shared component   Installs the component as a shared ActiveX component into the \Windows\System directory. This is the default.

Will this shared component be installed on a remote server and accessed through Remote Automation?

Yes — Application is installed on a remote server and accessed through Remote Automation.

No — Application is not accessed through Remote Automation. If your application is accessed remotely through Distributed COM (DCOM), you should select No.

Help   Displays the help topic for this step. You can also press F1 for help.

Cancel   Cancels your previous actions and closes the Setup Wizard.

Back   Moves you to the previous step.

Next   Moves you to the next step.

Finish   Creates a setup using the settings you selected and displays a confirmation dialog. Available only when you have provided enough information for the Setup Wizard to successfully create a setup package.


Setup Wizard - Single Directory
Setup Wizard — Single Directory

Gathers information the Setup Wizard needs to create a setup program that can be installed from a single directory.

Note   If you try to place files in a directory that is not empty, Setup Wizard tells you that there are files and/or subdirectories in that directory. You will be asked if you want to continue. If you choose Yes to continue, Setup Wizard will place the files in that location but will not delete any files. Files with the same name will be overwritten. You will have to delete other files yourself if you want to remove them.

Wizard Options

Destination   Lists the destination of the directory where you want to place the setup program and installation files. First you select the drive where you want your files placed. Then you type in the specific directory. If the directory does not exist, Setup Wizard will ask you if you want to create one. The last box allows you to see the structure of your path.

Note   Use the directory list box to change the path by double-clicking on the drive or folder you want to use as your destination.

Help   Displays the help topic for this step. You can also press F1 for help.

Cancel   Cancels your previous actions and closes the Setup Wizard.

Back   Moves you to the previous step.

Next   Moves you to the next step.

Finish   Creates a setup using the settings you selected and displays a confirmation dialog. Available only when you have provided enough information for the Setup Wizard to successfully create a setup package.


Setup Wizard - Multiple Directories
Setup Wizard — Multiple Directories

Gathers information the Setup Wizard needs to create a setup program that can be installed from multiple directories, or that can be copied from these directories to multiple floppy disks.

Note   If you try to place files in a directory that is not empty, Setup Wizard tells you that there are files and/or subdirectories in that directory. You will be asked if you want to continue. If you choose Yes to continue, Setup Wizard will place the files in that location but will not delete any files. Files with the same name will be overwritten. You will have to delete other files yourself if you want to remove them.

Wizard Options

Destination   Lists the destination of the directory where you want to install the application. First you select the drive where you want your files placed. Then you type in the specific directory. If the directory does not exist, Setup Wizard will ask you if you want to create one. The last box allows you to see the tree structure of your path.

Note   You can use the directory list box to change the path by double-clicking on the drive or folder you want to use as your destination.

Disk Size   Lists the available disk sizes.

Help   Displays the help topic for this step. You can also press F1 for help.

Cancel   Cancels your previous actions and closes the Setup Wizard.

Back   Moves you to the previous step.

Next   Moves you to the next step.

Finish   Creates a setup using the settings you selected and displays a confirmation dialog. Available only when you have provided enough information for the Setup Wizard to successfully create a setup package.


INF File

Lists the components required for installing the ActiveX components on your user's machine. The .inf file contains:

•	A list of all file dependencies needed for Internet download setup.

•	A list of linked .cab files and their locations.

•	Version information.

•	Class IDs for components.

•	Platform specific information.

•	Destination directory specifics.

•	Registry information for writing Safe for Initialization and Scripting entries.


Confirm Missing Dependencies Dialog Box

Confirms that you really do want to ignore the missing dependencies.

Dialog Box Options

Yes   Tells the Setup Wizard that you do want to proceed without the missing dependencies. Any additional files that may be needed may not be installed. If you choose Yes, any additional files that may be needed by the unselected files will not be installed. This may result in setup and your application not functioning properly.

If you are certain that a particular file does not have any dependencies and does not need to be registered in the system registry to function correctly, you should choose No.

If the indicated file(s) comes from a third party, contact that party for dependency information or for the necessary dependency files (.dep).

If the indicated file(s) is a Visual Basic component that you created, restart the Setup Wizard, select the project file for this component and the Generate Dependency File Only option, and continue through all the steps to create the missing dependency file. Then, restart the Setup Wizard and try the current project again.

No   Tells the Setup Wizard that you want to correct the missing dependencies.

Do not show this dialog again   When selected, this dialog never appears again.


Confirm Out of Date Dependencies Dialog Box

Confirms that you really do want to ignore the dependency information that is out of date.

Dialog Box Options

Yes   Tells the Setup Wizard that you do want to proceed with the out of date dependency information.

If you choose Yes, Setup Wizard attempts to use the out of date dependency information to build your setup program. This may mean that needed files will not be installed. As a result, setup and your application may not function properly.

If you are certain that the out of date dependency file contains the correct dependency information, choose Yes and continue.

If the indicated file(s) comes from a third party, contact that party for dependency information or for the necessary dependency files (.dep).

If the indicated file(s) is a Visual Basic component that you created, restart the Setup Wizard, select the project file for this component and the Generate Dependency File Only option, and continue through all the steps to create the missing dependency file. Then, restart the Setup Wizard and try the current project again.

No   Tells the Setup Wizard that you do not want to proceed but want to update the dependency information. This is the recommended choice.

Do not show this dialog again   When selected, this dialog never appears again.


File Details for ActiveX Server Dialog Box
File Details for ActiveX Server Component Dialog Box

Displays the following information about your ActiveX server component:

•	File information such as the file size and date it was created.

•	Installation information is not available at this time because it has not been determined yet.

•	Version information such as your company name, a description of the file, the version number, legal copyrights and trademarks, the product name and the product version number. The version information is displayed only when Setup Wizard can find it in the selected file.

OK   Closes the dialog box.

Help   Displays the help topic for this dialog. You can also press F1 for help.


File Details for Confirm Dependencies Dialog Box

Displays the following information for the dependencies:

•	File information such as the file size and date it was created.

•	Installation information is not available at this time because it has not been determined yet.

•	Version information such as your company name, a description of the file, the version number, legal copyrights and trademarks, the product name and the product version number. The version information is displayed only when Setup Wizard can find it in the selected file.

OK   Closes the dialog box.

Help   Displays the help topic for this dialog. You can also press F1 for help.


File Details for File Summary Dialog Box

Displays the following information for the selected file and allows you to change the installation information.

File information   File size and date the file was created.

Installation information

Destination Directory — You can type or choose the directory where this file will be installed on the end user's machine.

Note   If you are creating a setup for downloading from the Internet and you have a .vbl file selected, the Destination Directory list contains Do not install this file and Occache options. The default is Do not install this file.

The format for the destination directory starts with a predefined macro and has optional subdirectories. For example, if the Program Files directory is located at C:\Program Files, you could type

$(ProgramFiles)\MyCompany\MyApplication

to install the program files into the C:\Program Files\MyCompany\MyApplication directory. You can choose to enter an absolute path and ignore the pre-defined macros, but it is not recommended that you do so.

Install as a shared file — Indicates whether or not to install the file as a system shared component. If selected, the file will be removed only when the last program to use this file is uninstalled.

Register contained license information on the end user's machine. — Available only if the file is a Visual Basic ActiveX control license file (.vbl). If selected, the license information contained in the file will be registered on the end user’s machine. A .vbl file is created by Visual Basic for ActiveX control projects if you selected the Require License Key option on the General tab of the Project Properties dialog box.

Note   If you have a Visual Basic license file (.vbl), Setup Wizard adds the options, Do not install this file and Occache, to the Destination Directory list. Do not install this file is selected by default. If you select Do not install this file, the license file is registered but not installed on the end user's machine. Select Occache to have the .vbl file registered and installed into the Occache directory. Generally, you want the user to have the license file registered, but not installed on the machine, so that the user can use controls in an application and distribute the application with only the runtime version of the controls. An end user can register the .vbl files using RegEdit.

Version information   Your company name, a description of the file, the version number, legal copyrights and trademarks, the product name and the product version number. The Version information is displayed only when Setup Wizard can find it.

Caution   Changing either the shared file status or the Destination Directory of a shared file or remote ActiveX server may adversely affect the component’s capabilities and impair the removal of that component later. For example, if the same shared ActiveX component is installed to different directories, the removal of one of them may result in removal of the registry information that makes each of them accessible, rendering the remaining component inaccessible.

OK   Accepts the changes and closes the dialog box.

Cancel   Closes the dialog box without accepting any changes.

Help   Displays help for this dialog box.


The ActiveX Component you selected is not Self-Registerable.

You were attempting to add an ActiveX component using the Add button. However, the component that you selected does not appear to be capable of registering itself in the system registry.

For an ActiveX EXE server to be added in this step, it needs to support the command-line parameters, /RegServer and /UnRegServer, which tell the component to self-register and unself-register itself and then to do so silently.

For an Active X DLL server to be added in this step, it needs to support the DllRegisterServer and DllUnregisterServer DLL entry points.

The component that you selected does not contain the OLESelfRegister keyword in its version information. This keyword is normally built into components that are capable of self-registration. Some components, however, are capable of self-registration but do not have this keyword in their version information.

Yes   Tells Setup Wizard to add the component to the setup and cause it to be self-registered when installed. Choose Yes if you are certain that the component you selected supports the command-line parameters or the DLL entry points described here. If you choose Yes, but the component does not support self-registration, you may have errors in your setup application.

No   Tells Setup Wizard not to add the component at this step. You can add the file in the File Summary step, in which case it will be installed but not self-registered. You may need to modify your setup program by modifying the setup1.vbp project manually in your \Vb\Setupkit\Setup1 subdirectory to cause the necessary registration information to be added to the end user's machine.

Help   Displays help for this box.


Setup Wizard - Internet Package
Setup Wizard — Internet Package

Allows you to set options regarding the creation of the Internet package. When you choose to create an Internet Download setup, Setup Wizard creates a single .cab file, known as the primary .cab file, that contains the components for VB5-created ActiveX controls , ActiveX DLL, ActiveX EXEs, and ActiveX documents and links them to at least one other .cab file for the Visual Basic runtime.

A .cab file includes:

•	The project components such as the ActiveX control, ActiveX DLL, or ActiveX EXE.

•	The .inf file which contains safe for scripting and safe for initialization registry information as defined by the user, and links to other .cab files that contain VB support files and controls. This file replaces the setup.lst file that the Setup Wizard creates in the standard setup.

•	Reserved space for digital signatures.

•	All files that are not in other .cab files.

For ActiveX Control projects, ActiveX EXEs, and ActiveX DLLs, all runtime components such as  msvbvm50.dll, individual controls, Data Access Objects (DAO), and Remote Data Objects (RDO) are packaged into separate .cab files, digitally signed by Microsoft, and placed on the Microsoft web site. You can choose to link your files to the .cab files on the Microsoft web site or you can download local copies of them.

The benefit of using .cab files from an Internet web site are:

•	You do not need to distribute all of the .cab files required by your application. The only file you need to distribute is the primary .cab file.

The .inf file within the primary .cab file points to the Microsoft web site and downloads the necessary .cab files based on the needs of the end user.

•	They provide an efficient means of delivering updates to your product.

If you cannot or do not want to connect to the Internet, you may place the .cab files on a server within your intranet. This allows for faster downloading while allowing users to remain on a secured web.

Although Visual Basic, version 5.0, does not include any tools to digitally sign components, the Setup Wizard-generated .cab files reserve space for you to add a digital signature at a later time. To get your files signed you can:

•	Send them to a service provider such as VerSign, who keeps the private key. The service provider signs the files and returns them to you.

•	Purchase special hardware and/or software which stores your private key locally. When you are ready to sign your files, run a utility such as CodeSign to sign your files. The ActiveX SDK includes tools to create text signatures.

•	Use the ActiveX SDK to create test digital signatures.

Visual Basic, version 5.0, does not automatically create .lpk files which are required for components that require licensing if you plan to use them on HTML pages. The Setup Wizard works on a Visual Basic project level to create the necessary download components. The .lpk file must contain all of the licensing information for all of the components on a given HTML page. You can run LPK_Tool.exe from the \Tools directory on your Visual Basic CD after inserting all of the required ActiveX components on a given HTML page.

Wizard Options

Runtime Components

Download from the Microsoft web site — Links the files to the .cab files found on the Microsoft web site or any other web sites defined within the dependency (.dep) file. For example, a company could have a new .dep file for their component which points to their web site. The Setup Wizard writes the appropriate information into the .inf file in the .cab file it creates.

Use alternate location — Links the files to the .cab files found in an alternate location. Requires you to enter the URL or UNC where you have downloaded the .cab files or to leave the alternate location box blank if the .cab files will be in the same directory as the primary .cab file that the Setup Wizard creates. Blank is the Default.

This information is placed in the .inf file. If you put invalid information in the Use alternate location box, you can edit the .inf file that is located in the \Support directory and manually rebuild the .cab file using Makecab.exe. See your AciveX SDK for additional information.

Safety   Displays the Safety dialog box where you can determine which files are safe for initialization and/or safe for scripting. Microsoft Internet Explorer, version 3.0, has default security that requires that before any ActiveX component is instantiated on an HTML page, it must be marked Safe for Scripting and Safe for Initialization.

Help   Displays the help topic for this step. You can also press F1 for help.

Cancel   Cancels your previous actions and closes the Setup Wizard.

Back   Moves you to the previous step.

Next   Moves you to the next step.

Finish   Creates a setup using the settings you selected and displays a confirmation dialog. Available only when you have provided enough information for the Setup Wizard to successfully create a setup package.


Summary Details Dialog Box

Displays the summary details for the installation. It lists the following information:

•	Number of program files   Total number of user files that will be installed.

•	Number of setup files   Total number of additional files required by the installation, for example setup.exe.

•	Total number of files   Total number of files required by the installation.

•	Uncompressed bytes of program files   Total number of types of user files to be installed by the installation before compression.

•	Uncompressed bytes of setup files   Total number of types of additional files required by the installation before compression.

•	Total uncompressed bytes of all files   Total number of types to be installed before compression.

•	Setup Target   The path into which the distribution files will be placed when the Setup Wizard is finished.


Unable To Locate Dependency Information Dialog Box

Displays the name of a file for which no dependency information could be found.

The Setup Wizard has determined that the file is missing dependency information. This means that you are missing one or more dependency files (.dep) which provide information about other files that are needed in order to correctly install a component.

If an indicated file(s) comes from a third party, contact that party for dependency information or for the necessary dependency files (.dep).

If the indicated file(s) is a Visual Basic component that you created, restart the Setup Wizard, select the project file for this component and the Generate Dependency File Only option, and continue through all the steps to create the missing dependency file. Then, restart the Setup Wizard and try the current project again.

If you are certain that a file in the list does not need additional files to run, select it making sure that a check mark appears to the left of it. This will let the Setup Wizard know that this file has no dependencies, and the particular file will not appear in this dialog in the future.

Note   If you leave some files unchecked, a dialog appears asking if you want the Setup Wizard to ignore the missing dependency information. You can choose Yes and continue. You can also select not to see the dialog box in the future when you have missing dependency files.

Dialog Box Options

Yes   Include the file anyway.

No   Do not include the file.

Help   Displays a help topic for this dialog box.

Never warn me about this file's dependency information again   If selected does not show this dialog box again. You should choose this option only if you are certain that this file requires no other files and does not need to be registered in the system registry to function properly.


Macros for Installing Files

You can use macros in the Setup Wizard to indicate a path specified by a user. Listed below are macros that can be used in the Destination Directory box of the Files Details for File Summary dialog box.

Note   The macro you choose is usually used in the DefaultDir value in Setup.lst, and should not be used elsewhere. $(AppPath) or subdirectories of $(AppPath) should be the typical installation destination for application files, since this allows the user to change the installation location.

Macro	Installs into the
$(WinSysPath)	\Windows\System subdirectory under Windows 95 or the \Windows\System32 directory under Windows NT.
$(WinSysPathSysFile)	\Windows\System subdirectory under Windows 95 or the \Windows\System32 directory under Windows NT as a system file and is not removed when the application is removed.
$(WinPath)	\Windows directory.
$(AppPath)	Application directory specified by the user, or the DefaultDir value specified in the [SETUP] section of Setup.lst.
$(AppPath)samples	\Samples subdirectory below the application directory.
C:\path	Directory identified by path. Not recommended.
$(CommonFiles)	Common directory to which shared files are sometimes installed: c:\Program Files\Common Files\ (Windows 95, Windows NT, Version 4.0). c:\Windows (Window NT, Version 3.51).
$(ProgramFiles)	Directory to which applications are usually installed: c:\Program Files (Windows 95 Windows NT, Version 4.0). c:\(Windows NT, Version 3.51).
$(CommonFiles)\System	Subdirectory, System, of the common directory to which shared files are sometimes installed. Same as $(CommonFiles) with a subdirectory indicated.
$(MSDAOPath)	Location that is stored in the registry for Data Access Objects (DAO) components. You should not use this for your files.